home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-02 / clipwhat.zip / BINDSCRN.DOC < prev    next >
Text File  |  1993-01-04  |  6KB  |  124 lines
  1.  A. Purpose
  2.  
  3.     SAYWHAT! is really a handy utility to have!  The only
  4.     problem that I have is that I quite often forget to include
  5.     one or more 'SQZ" files with the distribution diskette.  Of
  6.     course, having a bunch of extra files in one's directory is
  7.     not 'neat' either.  This program will allow all of the
  8.     screens to be hidden within the '.EXE' file so that only
  9.     VIDPOP and the executable file need to be distributed.
  10.  
  11.  B. What is included
  12.     A number of files are included on the disk.  Both source and
  13.     executable versions of BindScrn are included so that you may
  14.     improve it.  An example Clipper program is also included in
  15.     source and executable forms as a demo.
  16.  
  17.     Please remember that since BindScrn uses SAYWHAT! screens,
  18.     VIDPOP must be resident to run this program.
  19.  
  20.  C. Equipment Required
  21.     In addition to Clipper and SAYWHAT!, the Microsoft assembler
  22.     is required to process the output of BindScrn.  I used MASM
  23.     Ver. 4.0 in developing this utility; I don't know much about
  24.     assembly language or assemblers so I don't know just how
  25.     version dependent the .ASM file may be (or which other
  26.     assemblers may be used).
  27.  
  28.     You must also have an appropriate version of SAYWHAT!  If
  29.     your version does not support including screens within Turbo
  30.     Pascal programs (as an external procedure) you will not be
  31.     able to use this utility.
  32.  
  33.  D. Usage
  34.  
  35.     1. Invoking the program
  36.  
  37.        Since the program will query for both input and output
  38.        paths, BindScrn can be located in any convenient directory
  39.        that is accessible with your path statement.  The path
  40.        assignments will be verified before they are accepted.  An
  41.        invalid path will be rejected and must be reentered.  If you
  42.        want to use the default directory for either or both input
  43.        or output simply press Return in the appropriate field(s).
  44.        The input path may be changed at any time that a new screen
  45.        name is prompted for by pressing ESC; the output path is
  46.        fixed since all the output files must be accessible to the
  47.        assembler.
  48.  
  49.        Similarly, the program only prompts for an output filename
  50.        once.  This is the name used for the assembly language file.
  51.        Each screen file processed will have a separate name
  52.        assigned automatically and the main file will call each of
  53.        these at assembly time.  The extension for the main file is
  54.        '.ASM' and the extension for the screen files is '.DAT'
  55.  
  56.        Finally, you are prompted for the name of a screen file.
  57.        This name is verified and if the file is not found reentry
  58.        is required until a valid filename is entered.  When you
  59.        want to quit processing just press Return with an empty
  60.        field and the program will complete processing and exit to
  61.        DOS.
  62.  
  63.        There are only two more fields displayed on the main screen.
  64.        One is a screen counter.  This is just a reminder of how
  65.        many screens have been processed.  The program is
  66.        arbitrarily limited to 25 screens.  The second item
  67.        displayed is a cumulative estimate of the size of the object
  68.        file that assembly will produce.  I have not taken too much
  69.        care to make it absolutely accurate since it is only
  70.        intended to show the effect on the resulting .EXE file's
  71.        size after linking.  One other possible problem could result
  72.        if the total size exceeded the amount of space available in
  73.        a segment; with the limit of 25 screens this should not
  74.        occur.
  75.  
  76.     2. Using the output
  77.  
  78.        a) Assembling the output files
  79.           There are two types of files output by BindScrn.  The main
  80.           file is 'filename.ASM'. In addition, each screen processed
  81.           results in a file 'Xscreenname.DAT'.  Naturally, if the
  82.           original screen name was eight characters long the last
  83.           character is lost in the new file.  For example,
  84.           MYSCREEN.SQX would become XMYSCREE.DAT.  These files may be
  85.           quite large (up to 12K).  Don't be alarmed by this, the size
  86.           will go back down to the original size after assembly.
  87.  
  88.           Just enter 'masm filename;' at the dos prompt to create the
  89.           linkable screen file.  This is named 'filename.OBJ'.  After
  90.           compiling your Clipper application the only step remaining
  91.           is to link.  The link command must include both the Clipper
  92.           file and the assembly file.  For the Microsoft linker the
  93.           command 'link clipname + assemblyname;' will suffice.  For
  94.           PLINK86 use 'plink86 FI clipname FI assemblyname'.  The
  95.           semicolon at the end of the commands using the MicroSoft
  96.           products suppresses further questions about listings etc.
  97.  
  98.     3. Clipper syntax
  99.  
  100.        Within your Clipper source disregard the usual way of
  101.        calling SAYWHAT! screens.  This is either 'run pop
  102.        screenname' or call popvid with 'screenname' depending on
  103.        what tools were previously available to you.  Just use 'call
  104.        screenname' to bring up a screen.  Note that using any of
  105.        the many other calls to vidpop still use the usual syntax;
  106.        ONLY THE SCREEN CALLS ARE DIFFERENT.
  107.  
  108.  
  109.  E. Notes
  110.     The author of these routines is:
  111.          Robert F. Hicks               Please let me know of any
  112.          7716 Harwood Place            problems that occur in
  113.          Springfield, VA 22152         using them.
  114.          Phone (703) 569-3496
  115.  
  116.     The routines are copyright (C) 1987 by Robert F. Hicks.  No
  117.     payment is requested or expected for individual use of this
  118.     package.
  119.  
  120.     If you use this tool in commercial or corporate applications
  121.     a contribution of $20 is requested.  Please remit to the
  122.     address above.
  123.  
  124.